Skip to content

Fast follow 2: refine orchestrate launch docs#117

Open
rachaelrenk wants to merge 7 commits into
mainfrom
fast-follow/orchestration-launch-docs-review-2
Open

Fast follow 2: refine orchestrate launch docs#117
rachaelrenk wants to merge 7 commits into
mainfrom
fast-follow/orchestration-launch-docs-review-2

Conversation

@rachaelrenk
Copy link
Copy Markdown
Contributor

@rachaelrenk rachaelrenk commented May 20, 2026

Summary

This PR is a broad fast-follow to the Cloud Agents launch docs, covering the Oz web app, agent identities, harness setup, and authentication guidance.

  • Clarify the Oz web app surface for cloud agents, including Quick run, saved agents, schedules, environments, integrations, and how orchestrated parent/child runs appear in the Runs page.
  • Tighten the Oz web app Agents section around saved agents as reusable cloud agent configurations, with concise links to deeper Skills as Agents and Agent identities references.
  • Refine agent identity documentation with more precise, cross-linked wording for team-scoped identities, editable fields, and deletion behavior.
  • Tighten harness and authentication guidance for Warp Agent, Claude Code, and Codex, with supporting screenshots for the harness selector and Claude Code auth secret setup.
  • Improve article readability by removing redundant callouts, incomplete detail tables, and extra section dividers from the Oz web app page.

Validation

  • git diff --check
  • npm run build

Conversation: https://staging.warp.dev/conversation/db4886fb-3576-4fbc-b694-e8f0852e4bb0

Co-Authored-By: Oz oz-agent@warp.dev

Co-Authored-By: Oz <oz-agent@warp.dev>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 20, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 21, 2026 4:20am

Request Review

@cla-bot cla-bot Bot added the cla-signed label May 20, 2026
@oz-for-oss
Copy link
Copy Markdown
Contributor

oz-for-oss Bot commented May 20, 2026

@rachaelrenk

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

Copy link
Copy Markdown
Contributor

@oz-for-oss oz-for-oss Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overview

This PR refines the cloud agent harness documentation for Warp Agent, Claude Code, Codex, and the harness overview, including clearer credential setup language and two new screenshots. I did not find correctness, security, style, or structure issues that need changes before merge.

Concerns

  • No blocking concerns found.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@rachaelrenk rachaelrenk self-assigned this May 20, 2026
@rachaelrenk rachaelrenk changed the title Refine cloud agent harness docs Fast follow: refine Cloud Agents launch docs May 21, 2026
Co-Authored-By: Oz <oz-agent@warp.dev>
Co-Authored-By: Oz <oz-agent@warp.dev>
@rachaelrenk
Copy link
Copy Markdown
Contributor Author

Pushed a scoped follow-up for the Oz web app launch docs review in afff0fa (Tighten Oz web app docs).

What changed and why:

  • Folded orchestrated runs into the Runs section — Moved the parent/child run inspection guidance under ## Runs as ### Inspecting orchestrated runs because this content explains how orchestration appears in the web app’s run-management surface, not a separate top-level product area.
  • Removed the “Where to start an orchestration” subsection — Cut the web-app-specific orchestration-starting guidance, including the orchestrate-mode phrasing, because the canonical start flow already lives in the orchestration docs and this page should stay focused on web app orientation.
  • Tightened the Agents section around the user goal — Kept the core definition of agents as reusable cloud agent configurations, shortened the skills explanation, and kept a concise mention of the team-scoped identity model so readers understand what saved agents do without re-expanding the full identity model here.
  • Removed the Agent details table — Replaced the incomplete list-view table with a sentence explaining that opening an agent shows prompt, skills, harness, model, environment, and secrets. This avoids a mismatch between the table fields and the fuller saved-agent configuration described in the section.
  • Updated Quick reference and Runs wording — Changed the Agents row to “saved and suggested agents,” clarified that Runs can cover account and team activity where applicable, and changed search wording from “skill name” to “agent name” to better match the current user-facing model.
  • Simplified procedural copy — Removed note callouts that only said which button to click, tightened the new-run explanation to avoid repeating Quick run, shortened the new-agent creation flow, and added punctuation to numbered steps.
  • Removed body horizontal dividers — Dropped the repeated --- dividers because they made the article feel fragmented after the scoped edits; headings now carry the structure.

Validation:

  • git diff --check passed.
  • npm run build passed (334 pages built; existing non-blocking prerender warnings still appear).

@rachaelrenk rachaelrenk changed the title Fast follow: refine Cloud Agents launch docs Fast follow 2: refine orchestrate launch docs May 21, 2026
Co-Authored-By: Oz <oz-agent@warp.dev>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant